Help

Creating a Link

A link consists of a short alias and a destination URL. Click the Create button on the home page, fill in both fields, and save.

For example, creating a link with alias google and URL https://google.com means navigating to https://go.d1m.dev/google will redirect you there.

Editing & Deleting Links

Each link in the table has action buttons on the right side. Click the pencil icon to edit the alias or URL. Use the delete option in the same menu to remove a link.

Dynamic Link Parameters

Links support $1, $2, etc. placeholders in the URL. Extra path segments after the alias are substituted into these positions.

For example, a link with alias gh and URL https://github.com/$1/$2 means:

https://go.d1m.dev/gh/owner/repo → https://github.com/owner/repo

Aliases can also contain slashes for namespacing, e.g. alias docs/api with URL https://docs.example.com/api/$1.

Using Links with Gists as Scripts

Create a link pointing to a GitHub gist raw URL with parameters, then use it as an executable script:

# Create a link with alias "gist" and URL:
# https://gist.githubusercontent.com/$1/raw/$2

# Then run it locally:
curl -sL https://go.d1m.dev/gist/{user}/{hash} | bash

# Or:
bash <(curl -sL https://go.d1m.dev/gist/{user}/{hash})

This works because the app performs an HTTP 302 redirect, so any tool that follows redirects can use go links programmatically.

Browser Setup

You can configure your browser to treat the address bar as a go links launcher by adding a custom search engine.

Chrome

• Navigate to chrome://settings/searchEngines
• Click "Add" next to Site Search
• Set the keyword to go (or any short keyword you prefer)
• Set the URL to https://go.d1m.dev/%s

After setup, type go in the address bar, press Tab, then type your alias to navigate directly.

Firefox

• Bookmark any page from your deployment
• Edit the bookmark and set a keyword (e.g., go)
• Change the URL to https://go.d1m.dev/%s

Type your keyword in the address bar followed by the alias to navigate directly.

Running Locally

Prerequisites:

• Node.js
• Docker (for the database)
• yarn

# Start PostgreSQL
docker-compose up -d db

# Run database migrations
export DATABASE_URL=postgres://dev:dev@127.0.0.1:5432/golinks?sslmode=disable
dbmate up

# Install dependencies
yarn

# Start development server
yarn dev

Create a .env.local file based on .env.example. To disable authentication, set AUTH0_ENABLED=false.

Deploying

Docker

docker build . -t golinks
docker run -p 3000:3000 --env-file .env golinks

A pre-built image is available at armand1m/golinks.

Fly.io

fly deploy
fly secrets set DATABASE_CONNECTION_STRING=...
fly secrets set AUTH0_DOMAIN=...

See fly.toml for the deployment configuration.

Kubernetes

Kubernetes manifests are available in the ./kubernetes directory of the repository, including Cloud SQL proxy setup and secrets configuration.

Repository

The source code is available at github.com/armand1m/golinks. The project is licensed under MIT. Contributions, bug reports, and feature requests are welcome via issues and pull requests.