🚀 Getting Started with 404

Welcome! This guide will help you get started with 404's services quickly and easily.

🌟 What is 404?

404 is a privacy-focused platform offering:

• Anonymous file sharing - Upload and share files without registration
• Bookmarking service - Save and share your favorite links
• Git repository hosting - Host your code with SSH/HTTPS access
• IRC chat - Old-school chat with Tor support
• Paste service - Share code snippets and text
• Wiki pages - Create and share markdown content
• NEW Email service - Send and receive anonymous emails

All services prioritize privacy, security, and anonymity.

📁 File Sharing

Upload Your First File

1. Via Web Browser:

- Visit the homepage

- Click "Choose File" or drag and drop

- Optionally set a password and expiration time

- If you're logged in, you can choose to share it anonymously or under your account

- Click "Upload"

- Copy the generated link to share

1. Via Command Line:

curl -F "file=@document.pdf" https://4-0-4.io/api/upload

Download a File

Simply visit the URL provided after upload:

https://4-0-4.io/file/abc123

If password protected, you'll be prompted to enter it.

Manage Your Files

If you have an account, you can view and manage your uploads:

1. Log in to your account
2. Navigate to "Account"
3. Scroll down to see your uploaded files (and delete or manage them)

💬 IRC Chat

Connect in 3 Steps

1. Install an IRC client (WeeChat, HexChat, irssi)
2. Connect to the server:

Server: irc.4-0-4.io
Port: 6667 (No SSL)

1. Join a channel:

/join #chat

That's it! No registration required to start chatting.

Quick Connect

WeeChat:

/server add 404 irc.4-0-4.io/6667 -no-ssl
/connect 404
/join #chat

HexChat:

• Add network: irc.4-0-4.io/6667
• Disable SSL
• Connect and join #chat

🌳 Git Hosting

Browse Repositories

ssh git.4-0-4.io

This launches an interactive TUI to explore public repositories.

Clone a Repository

git clone git@git.4-0-4.io:repository-name.git

Create Your First Repository

1. Git initialize locally:

mkdir my-repo
cd my-repo
git init
echo "# My Repo" > README.md
git add README.md
git commit -m "Initial commit"

1. Create a new repository on 404 (or ask Dasho to create it for you)
2. Set repository visibility (public/private)
3. Set up SSH keys in your account for authentication (again ask Dasho if you need help)
4. Push your code:

git remote add origin git@git.4-0-4.io:your-repo.git
git push -u origin main

📝 Paste Service

Create a Paste

Via Web:

1. Visit /paste
2. Enter your code or text
3. Select language for syntax highlighting
4. Click "Create Paste"

Via API:

curl -X POST https://4-0-4.io/api/paste \
  -H "Content-Type: application/json" \
  -d '{"content":"print(\"Hello!\")","language":"python"}'

Share a Paste

The generated URL can be shared directly:

https://4-0-4.io/paste/xyz789

For raw content:

https://4-0-4.io/paste/xyz789/raw

🔐 Privacy & Security

Anonymous Usage

Most services work without registration:

• Upload files without an account
• Join IRC without registering
• Browse public git repositories
• Create pastes anonymously

Tor Access

Access all services via Tor for maximum anonymity:

# IRC Onion Address
iibkaohpbc7jizrszt7ve6tpxlnzd3osvaocv2r5wh3ojzi2trysg5id.onion

# Web Onion Address (if available)
# Contact admins for current address

Best Practices

1. Use strong passwords for protected files
2. Set appropriate expiration times to minimize data retention
3. Don't share sensitive data in public channels or pastes
4. Verify SSL certificates when connecting
5. Use Tor or VPN for additional privacy

🔧 Account Features (Optional)

While you don't need an account, registering provides benefits:

Create an Account

# Via web interface
# Navigate to /account and sign up

Benefits

• File management - View and manage your uploads
• Longer retention - Extended expiration times
• Private repositories - Host private git repos
• Channel ownership - Register IRC channels
• Statistics - View usage stats

🛠️ Command Line Tools

File Upload Script

#!/bin/bash
# Save as ~/bin/upload
file=$1
curl -F "file=@$file" https://4-0-4.io/api/upload | jq -r '.url'

Make it executable:

chmod +x ~/bin/upload
upload document.pdf

Paste from Clipboard

# Linux
xclip -o | curl -X POST https://4-0-4.io/api/paste \
  -H "Content-Type: application/json" \
  -d "{\"content\":\"$(cat -)\"}" | jq -r '.url'

# macOS
pbpaste | curl -X POST https://4-0-4.io/api/paste \
  -H "Content-Type: application/json" \
  -d "{\"content\":\"$(cat -)\"}" | jq -r '.url'

🆘 Getting Help

Documentation

• API Documentation - Programmatic access
• Git Server Guide - Git hosting details
• IRC Guide - IRC setup and commands

Support Channels

1. IRC - Join #help on irc.4-0-4.io
2. Git Issues - Report bugs via my github / email (bugs@dasho.dev)
3. Forum - Community discussions (if available)

Common Issues

Can't upload files?

• Check file size (max 100MB)
• Ensure proper file format
• Try using API if web interface fails

IRC connection issues?

• Verify SSL is enabled
• Check firewall settings
• Try the onion address via Tor

Git authentication fails?

• Ensure SSH key is added to your account
• Check SSH agent: ssh-add -l
• Verify remote URL is correct

🎯 Next Steps

Now that you're set up:

1. Explore the TUI - ssh git.4-0-4.io
2. Join the community - Connect to IRC and say hello
3. Read the docs - Check out service-specific guides
4. Share your feedback - Help me improve my services by sharing your experience and suggestions!

📚 Additional Resources

• API Reference
• Security Best Practices
• Git Server Documentation
• IRC Documentation

Questions? Join #help on IRC or consult the documentation!