Complete User & Developer Guide

GPHost Documentation & Help Center

Everything you need to know about GPHost — how to upload files in seconds, password-protect links, set expiration timers, use developer API keys, and organize your storage in simple, easy-to-read English.

What is GPHost? (The 1-Minute Overview)

GPHost is a private, lightning-fast file hosting platform. Whether you need to share school homework, photos, videos, game files, or code projects, GPHost lets you upload files and instantly get clean, shareable links.

Fast & Direct

1-Click Uploads

Drop any file to get a short link immediately. No ads, no popups.

Privacy First

Password Protected

Lock your file with a secret passcode so only the right person can open it.

Self-Cleaning

Auto-Expiring Links

Set your link to disappear after 1 hour, 1 day, or 30 days automatically.

Dashboard Tour & Navigation

When you log into your console, the left navigation bar gives you easy access to everything:

Overview: Your account homepage showing quick stats, total files stored, and storage used.

Upload: The dedicated upload station where you can drag and drop multiple files at once.

Files: View your complete file catalog, preview images/videos, copy sharing links, or delete files.

Links: Manage active sharing links, view download counts, or change passwords on existing links.

Expiring: Track files scheduled to auto-delete soon so you never exceed your storage space.

Settings: Change your display name, view your storage quota, and generate Developer API keys.

How to Upload Files (Drag & Drop)

Uploading on GPHost is as simple as dropping a file onto your screen:

Go to the Upload Tab

Click Upload in the left sidebar or the top navigation bar.

Drag and Drop Your File

Drag pictures, documents, videos, or archives right into the box, or click the box to browse your computer.

Choose Password or Expiry (Optional)

If you want extra protection, type a secret password or pick how many days the file should stay online before auto-deleting.

💡 Supported Files: Images (PNG, JPG, SVG, GIF, WebP), PDFs, Word & PowerPoint files, MP4 videos, MP3 audio, ZIP files, code files, and text.

Managing & Previewing Files

On the Files page, you have full control over your stored items:

Instant Preview

Click on any photo, video, or PDF to preview it directly inside your browser without needing to download it.

1-Click Copy Link

Click the link icon beside any file to copy the direct URL to your clipboard. Paste it into WhatsApp, Discord, or email.

Expiring Links & Auto-Cleanup

Nobody likes clutter. If you share a draft or a quick screenshot with a friend, you probably don't need it taking up space 6 months later.

How Expiring Works:

When uploading, you can set the file to expire after 1 hour, 1 day, 7 days, or 30 days.
When the countdown finishes, the link stops working and the file is permanently wiped clean.
This ensures your private data never stays floating on the web forever!

Password Protecting Your Files

Want to send confidential documents, grades, or personal photos? You can lock your file with a password:

How the Receiver Experiences It:

When someone clicks your link, they will see a secure lock screen asking for the passcode. They cannot download or view the file until they type the password you gave them!

Permanent vs Standard Links

Standard Accounts

Up to 90 Days

Files stay online for up to 90 days. Ideal for day-to-day file sharing, homework, and sending materials to friends.

Approved Accounts

Never Expire (Permanent)

Your files remain live permanently! Perfect for website images, portfolio downloads, and long-term project archives.

Developer API: What is an API Key?

If you code, run automated tests, or prefer using your terminal, you don't have to open a web browser to upload. An API Key is like your secret digital VIP badge. When your computer sends a file with this badge, GPHost verifies it and saves it into your account immediately.

🔑 The Brass Key Analogy: Instead of typing your Google password each time, your computer shows your API key (starting with gp_live_...). That's all it takes!

Creating & Masking API Keys

Head to Settings to create your key:

Click "+ New API Key"

Type a nickname (e.g., "MacBook CLI" or "School PC").

Masked with Asterisks for Privacy

When generated, your key is masked: gp_live_********************. Click Reveal to see it, or click Copy Key to copy the raw unmasked secret directly.

Expanded View for Many Keys

Have 10 or 20+ keys? Click Expand View to open a searchable modal where you can review, copy prefixes, or revoke keys cleanly.

1-Line Terminal Upload (cURL)

Open your computer terminal and paste this single command:

Terminal Command

curl -H "Authorization: Bearer gp_live_YOUR_KEY" \
  -F "file=@photo.jpg" \
  https://gphost.app/api/v1/upload

For Windows (PowerShell & Command Prompt)

Windows PowerShell

curl.exe -H "Authorization: Bearer gp_live_YOUR_KEY" `
  -F "file=@homework.pdf" `
  https://gphost.app/api/v1/upload

Python in 5 Lines (Automated Uploads)

upload.py

import requests

API_KEY = "gp_live_YOUR_KEY"
URL = "https://gphost.app/api/v1/upload"

with open("homework.pdf", "rb") as f:
    headers = {"Authorization": f"Bearer {API_KEY}"}
    files = {"file": f}
    response = requests.post(URL, headers=headers, files=files)

data = response.json()
print("Link to share:", data["file"]["url"])

Revoking & Key Safety Rules

Keep it Private Like an ATM PIN

Never share your raw key on public Discord servers or commit it to GitHub.

Revoke in 1 Click if Leaked

If someone saw your key, go to Settings and click the trash can icon. It is deleted immediately.

Profile & Storage Quotas

In your Settings page, you can customize your experience:

Display Name

Type your name or nickname and click Save. It appears when sharing files.

Storage Bar

The bottom of your sidebar tracks your storage in real time so you never run out of room.

Frequently Asked Questions (FAQ)

Is GPHost free to use?

Yes! All standard file hosting and terminal upload features are completely free.

Can anyone see my uploaded files without a link?

No. Your files are private to your account. Nobody can view or download a file unless you share the exact link with them.

Can I delete a file after sharing it?

Yes, at any time! Just go to the Files tab and click Delete. The link will immediately stop working.

Ready to start using GPHost?

Go to your dashboard or upload your first file right now.

Dashboard Upload File

import requests API_KEY = "gp_live_YOUR_KEY" URL = "https://gphost.app/api/v1/upload" with open("homework.pdf", "rb") as f: headers = {"Authorization": f"Bearer {API_KEY}"} files = {"file": f} response = requests.post(URL, headers=headers, files=files) data = response.json() print("Link to share:", data["file"]["url"])