Connecting to Server
Before using Expose, you need to connect the app to your server.
Initial Setup
- Open Expose from your Applications folder
- Click the menu bar icon → Open Dashboard
- Go to Settings (gear icon)
- Click the Account tab
Server Configuration
Enter your server details:
| Field | Value | Example |
|---|---|---|
| API Server URL | Your server’s API endpoint | https://api.yourdomain.com |
| Tunnel Domain | Your tunnel subdomain | expose.yourdomain.com |
Creating an Account
If you don’t have an account yet:
- Enter your server URL
- Click Create Account
- Enter your email and password
- Click Register
Your account is created and you’re automatically logged in.
Signing In
If you already have an account:
- Enter your server URL
- Click Sign In
- Enter your email and password
- Click Login
API Key
After signing in, you need an API key to use tunnels:
- Go to Settings → Account
- Click Create API Key
- Give it a name (e.g., “MacBook Pro”)
- Copy the key immediately — you won’t see it again
The API key is saved automatically and used for all tunnel connections.
Testing Connection
To verify everything works:
- Go to the Projects tab
- You should see your configured scan directories
- If projects are detected, the connection is working
Multiple Servers
Currently, Expose supports connecting to one server at a time. To switch servers:
- Go to Settings → Account
- Click Sign Out
- Enter the new server URL
- Sign in with your credentials for that server
Troubleshooting
Connection Failed
- Verify the server URL is correct (include
https://) - Check your internet connection
- Ensure the server is running:
curl https://api.yourdomain.com/health
Invalid Credentials
- Double-check your email and password
- Try resetting your password
API Key Not Working
- Ensure the key was copied completely
- Try creating a new API key
- Check the key hasn’t been revoked
Certificate Errors
- Ensure your server has valid TLS certificates
- Check certificate hasn’t expired
- Verify DNS is configured correctly