Hostish

Host websites, local apps, and Minecraft Java servers from your own device.

Create Account

Your username becomes your Hostish hostname. Example: username.hostish.site

One Hostish account works with both the normal website agent and the dedicated Minecraft agent.
Usernames should be 3 to 32 characters and use lowercase letters, numbers, or hyphens. Some names are reserved.

Choose what you want to host

Website / local app

Static files Local apps APIs

Use the normal Hostish agent for websites, APIs, Flask/FastAPI/Node applications, and other HTTP services.

Minecraft Java server

Minecraft Java TCP tunnel

Use the dedicated Minecraft agent for a Minecraft Java server running on your computer.

Website / App Setup

Static Proxy Hybrid

1. Download the normal Hostish agent:

2. Edit the top settings in agent.py: 

USERNAME = "your_username"
PASSWORD = "your_password"
WEBSITE_DIR = "C:/path/to/site"

# Choose:
# MODE = "static"
# MODE = "proxy"
# MODE = "hybrid"

3. Run it: 

python agent.py

The normal agent prints your public HTTPS URL when it connects.

Minecraft Server Setup

Minecraft Java Port 25565 No router forwarding

1. Download the dedicated Minecraft agent:

2. Open minecraft-agent.py in a text editor and enter your Hostish account information: 

USERNAME = "your_username"
PASSWORD = "your_password"

# Usually leave these unchanged:
MINECRAFT_HOST = "127.0.0.1"
MINECRAFT_PORT = 25565
Your username and password are configured by editing the Python script. The Minecraft agent does not prompt for them when it starts.

3. Optionally tell Hostish where your Minecraft server's start.bat is: 

# Automatically start your Minecraft server:
START_BAT = r"C:\path\to\server\start.bat"

# Or leave blank to start the server yourself:
START_BAT = r""

If START_BAT is configured, Hostish first checks whether Minecraft is already running. If it is offline, the agent launches the batch file and waits for the server to start.

Leaving START_BAT = r"" is completely valid. In that mode, simply start your Minecraft server manually before players join.

4. Optionally choose an HTML file to display when someone visits your Hostish address in a normal browser: 

# Optional browser homepage:
HOMEPAGE_FILE = r"C:\path\to\minecraft-home.html"

# Leave blank to disable:
HOMEPAGE_FILE = r""

When enabled, visiting https://USERNAME.hostish.site/ will display that HTML file while the Minecraft agent is connected.

A self-contained HTML file works best. Put the page's CSS and JavaScript directly inside the HTML file when possible.

5. Install the required Python packages once: 

python -m pip install websockets certifi

6. If START_BAT is blank, start your Minecraft server now.

If you configured START_BAT, Hostish can do this automatically instead.

7. Run the agent: 

python minecraft-agent.py

8. Once connected, it displays your public Minecraft address: 

Minecraft address: USERNAME.hostish.site
Minecraft player ↓ USERNAME.hostish.site:25565 ↓ Hostish VPS ↓ Hostish Minecraft tunnel ↓ minecraft-agent.py ↓ 127.0.0.1:25565 ↓ your Minecraft server

How Website Hosting Works

Static mode

Serves files directly from your WEBSITE_DIR.

  • Good for HTML, CSS, and JavaScript
  • Folder requests can map to index.html
  • Custom 404 pages are supported

Proxy / Hybrid mode

For applications, APIs, AI backends, and mixed sites.

  • Proxy: forward all requests to a local application
  • Hybrid: combine static files and proxied paths
  • Local applications can remain on 127.0.0.1
If a route is missing and custom 404 is disabled, Hostish can use https://hostish.site/404/.

How Minecraft Hosting Works

Minecraft does not use Hostish's HTTP proxy. The Minecraft agent carries raw Minecraft TCP traffic through its own tunnel.

Minecraft players ↓ Hostish VPS :25565 ↓ outbound WebSocket tunnel ↓ minecraft-agent.py ↓ 127.0.0.1:25565

Optional Automatic Server Start

Hostish can launch your existing Minecraft start.bat for you. 

START_BAT = r"C:\path\to\server\start.bat"

When the Minecraft agent starts:

Check 127.0.0.1:25565 ↓ Already running? ↓ yes ↓ no Use server Run start.bat ↓ Wait for Minecraft ↓ Start Hostish tunnel

If you prefer manual startup: 

START_BAT = r""

Optional Minecraft Browser Homepage

The Minecraft agent can also provide a simple webpage at your normal Hostish URL.

Browser: https://USERNAME.hostish.site/ ↓ Hostish ↓ your HOMEPAGE_FILE HTML Minecraft: USERNAME.hostish.site:25565 ↓ Hostish ↓ your Minecraft server

Configure it inside minecraft-agent.py: 

HOMEPAGE_FILE = r"C:\path\to\minecraft-home.html"

Or disable it: 

HOMEPAGE_FILE = r""

Important Notes