Skip to content

ryan-willis/ipboard

Repository files navigation

https://ipboard.link

About

ipboard is a simple web app that allows you to share text or a file between devices connecting from the same external IP. It's only really useful for sharing between your phone and personal computer (or work computer) when they're on the same network.

Running ipboard

Docker

To run the application yourself, you can use the Docker image:

docker run -d ip 8000:8000 ghcr.io/ryan-willis/ipboard:latest

Then visit http://localhost:8000 in your browser.

Docker Compose

You can also use Docker compose (if you've checked out the repo):

docker compose up -d

Here's a minimal configuration for docker-compose.yml:

services:
  ipboard:
    image: ghcr.io/ryan-willis/ipboard:latest
    ports:
      - 8000:8000

The SQLite database will be stored in a volume at /data/ipboard within the container so data will persist between container restarts. You can add your own volume to the ipboard service to persist the data on the host machine:

docker run -d ip 8000:8000 -v ~/.ipboard:/data/ipboard ghcr.io/ryan-willis/ipboard:latest
volumes:
  ipboard:

services:
  ipboard:
    image: ghcr.io/ryan-willis/ipboard:latest
    ports:
      - 8000:8000
    volumes:
      - ipboard:/data/ipboard

Environment Variables

  • IPBOARD_DB_PATH

    • The path to the SQLite database (defaults to local.db when running locally and /data/ipboard/ipboard.db when running in a container).
  • IPBOARD_FILES_PATH

    • The path to the directory where uploaded files are stored (defaults to ./files when running locally and /data/ipboard/files when running in a container).

Local Development

Run the Deno Fresh dev server (full stack):

deno task start

About

Share text or a file between devices connecting from the same external IP.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors