Skip to main content

​
Setup User

To use Oxen, you’ll need to set up a local Oxen username and email. This is what will show up in oxen log or in the OxenHub dashboard for who changed what. 
oxen config --name "YOUR_NAME" --email "YOUR_EMAIL"
This will save the user to ~/.config/oxen/user_config.toml for future use.

​
Auth Tokens

Pushing data or cloning private repositories requires a valid API Key. You can obtain one by creating an account on and going to your profile. Oxen.ai authentication key The token can then be set with oxen config --auth. 
oxen config --auth 'hub.oxen.ai' YOUR_AUTH_TOKEN
This will write the auth token to ~/.config/oxen/auth_config.toml. To push or access repositories on Oxen.ai, set the host as hub.oxen.ai. If you set up your own oxen-server, you can generate custom auth tokens there.