hosting
v1.2.0
Published
Deploy the current folder to 1freehosting.com with one command.
Downloads
272
Maintainers
Readme
hosting
Deploy the current folder to 1freehosting.com with one command. No account, no config.
npm i -g hosting
hostingor without installing:
npx hostingOutput:
Uploading 3 files (12.4 KB)...
Live site: https://1freehosting.com/s/happy-panda-482
Claim link: https://1freehosting.com/claim/xxxxxxxx-...
The claim link is private and single-use: open it and sign in to
manage the site. Run `hosting claim` to open it in your browser.Commands
| Command | What it does |
| --- | --- |
| hosting | Deploy the current folder (updates the linked site, or creates one) |
| hosting deploy [dir] | Deploy a specific folder |
| hosting link <subdomain> | Link the current folder to an existing site |
| hosting claim | Open the last deploy's claim link in your browser |
| hosting open | Open the last deploy's live site in your browser |
Options
--name <name>— set the site name (defaults to the page<title>)--new— create a fresh site even if the folder is already linked to one--token <token>— deploy token forhosting link(or setHOSTING_DEPLOY_TOKEN)--claim— open the claim link in your browser right after deploying
Updating a site
The first deploy creates a site and saves its deploy token to .hosting.json. Every later deploy from the same folder sends that token and updates the same site — before and after you claim it. Claiming attaches the site to your account; the token keeps working, and you can view or regenerate it in the dashboard.
To deploy an existing site from another machine or CI, link the folder first:
hosting link happy-panda-482 --token <token-from-dashboard>
hostingTo start over with a fresh URL, run hosting --new.
Notes
- Limits: 500 files, 50 MB per site. Hidden files and folders (anything starting with
., like.envor.git),node_modules, and OS junk files are skipped automatically. - Unclaimed sites expire 24 hours after the last deploy. Claim a site to keep it online permanently. If a linked site has expired, the next deploy tells you and creates a new one.
.hosting.jsoncontains the deploy token and claim link — keep it private. The CLI adds it to.gitignoreautomatically when one exists.- The claim link is single-use and can't be recovered. If you want to keep the site, claim it before it expires.
About
This CLI is the open-source companion to 1freehosting.com. Deploys are anonymous by default; opening the claim link and signing in attaches the site to your account so you can manage it from the dashboard.
License
MIT
