Access Tokens

Access tokens let you authenticate with the Self-Host Pro Docker registry to pull image updates.

When you need an access token

The install script handles authentication automatically during initial setup. You only need to manually create an access token if you want to:

• Pull updates manually with docker pull
• Set up automated updates on your server
• Use a different Docker client

Creating an access token

1. Go to app.selfhostpro.com/my-products
2. Sign in with your email
3. Scroll to the Access Tokens section
4. Click Create Access Token
5. Copy your credentials — the token is only shown once

You'll receive:

• Username — Your email address
• Token — A secure password for Docker authentication

Using your access token

Log in to the registry

docker login shpcr.io -u [email protected] -p your-token

Or use stdin to keep the token out of shell history:

echo "your-token" | docker login shpcr.io -u [email protected] --password-stdin

Pull updates

After logging in, you can pull the latest images:

docker pull shpcr.io/team/product:latest

Then restart your application:

cd /srv/your-product
docker compose up -d

Managing tokens

From your dashboard, you can:

Regenerate a token

Creates a new token and invalidates the old one. Use this if you think your token may have been compromised.

1. Find your token in the Access Tokens section
2. Click the menu (three dots)
3. Select Regenerate
4. Copy the new token

Delete a token

Permanently removes the token. You'll need to create a new one to authenticate again.

1. Find your token in the Access Tokens section
2. Click the menu (three dots)
3. Select Delete

Token security

• Tokens grant pull access to all products you've purchased
• Store tokens securely — don't commit them to version control
• If you suspect a token is compromised, regenerate it immediately
• The "Last used" timestamp helps you identify unused or suspicious tokens