How to Deploy a Link Directory with Docker in 10 Minutes

Docker is the fastest way to get your self-hosted link directory running. Follow these steps and you'll have the container built, tagged, and pushed to your repository in about ten minutes.

1Build & Run the Container

Navigate to the directory containing your `compose.yml` file in your terminal, then build the image and start the container in one command:

docker compose up --build

This command does two things: it builds the Docker image (if it doesn't exist yet) and then starts a container based on that image.

2Tag the Image (Optional but Recommended)

After running the build, tag your image so it's easy to identify and share. For example:

docker tag <original_image_name> <your_repository_name>/<image_name>:latest

• Replace <original_image_name> with the name Docker assigned after building (something like my-app).
• Replace <your_repository_name> with your Docker Hub username or organization.
• Replace <image_name> with a name you want for the image (e.g., my-app).

The :latest tag simply marks the most recent version of the image.

3Push to Your Docker Repository

Make sure you're logged into your Docker Hub account:

docker login

Then push the tagged image to your repository:

docker push <your_repository_name>/<image_name>:latest

This uploads your image to your Docker Hub account, making it accessible for deployment anywhere.

Start Using Your App

Once deployed, point your browser at your domain and use these routes to set everything up:

• /install — run the initial setup
• /password — get your login password
• /login — log in to the dashboard
• /create — add a new link or item
• /send — send a message