docs

everything you need to know about using holsterjr hosting.

getting started

get an invite code from an admin
sign in on the dashboard with discord using your invite code
run !server create python mybot or !server create nodejs myapp in discord
go to the dashboard to configure your server
deploy your github repo, set env vars, and start your server

discord commands

the discord bot is used to create servers. all other management is done in the dashboard.

`!server create <runtime> <name>`	create a new server
`!servers`	list your servers
`!status`	view system status
`!help`	show help
`!invite [max_uses]`	generate invite code (admin)
`!admin users`	list all users (admin)
`!admin kill <pm2_name>`	force stop any app (admin)

dashboard features

console — view live pm2 logs
files — browse your app's source code
deploy — deploy from a github repo or pull latest changes
env vars — set, edit, and delete environment variables
settings — configure entry file, port, branch
api tokens — create personal access tokens for api access

supported runtimes

runtime	command	install	entry file
node.js	`!server create nodejs`	`npm install`	`index.js`
python	`!server create python`	`pip install -r requirements.txt`	`main.py`
deno	`!server create deno`	none	`main.ts`

limits

3 servers per user (configurable by admin)
200mb ram per server (auto-restart on exceed)
1 deploy per 5 minutes rate limit
public github repos only
no root/sudo access

api tokens

create personal access tokens (PATs) in the dashboard under "api tokens". tokens start with hjh_ and are hashed before storage — the raw token is only shown once when created. use them as Authorization: Bearer hjh_...to access the api programmatically. tokens support permission scopes and optional expiry.