Skip to main content

Frequently Asked Questions (FAQ)

General Questions​

What is CyberPaste?​

CyberPaste is a modern, secure pastebin application that allows users to share code snippets, text, and other content. It features Discord OAuth authentication, syntax highlighting, password protection, and an intuitive admin panel.

Is CyberPaste free to use?​

CyberPaste is a self-hosted application that requires a commercial license. You need a valid license key to run the application. Contact the developers for licensing information.

What are the system requirements?​

  • Node.js: Version 18 or higher
  • MongoDB: Version 5.0 or higher
  • Operating System: Linux, macOS, or Windows
  • RAM: Minimum 512MB (1GB+ recommended)
  • Disk Space: Varies based on usage (minimum 100MB for installation)

Can I use CyberPaste without Discord?​

No, Discord OAuth2 is required for authentication. However, you can create pastes without being logged in. Authentication is only required for accessing the admin panel.

Is CyberPaste open source?​

CyberPaste is a commercial application with a proprietary license. The source code is not open source.

Installation & Setup​

How do I install CyberPaste?​

  1. Clone the repository
  2. Install dependencies with npm install
  3. Configure config.yml with your settings
  4. Set up Discord OAuth application
  5. Configure MongoDB connection
  6. Start the application with npm start

For detailed instructions, see the Installation Guide.

How do I get a Discord OAuth application?​

  1. Go to Discord Developer Portal
  2. Create a new application
  3. Go to OAuth2 → General
  4. Add redirect URI: https://yourdomain.com/auth/discord/callback
  5. Copy Client ID and Client Secret
  6. Add them to your config.yml

What MongoDB connection string should I use?​

For local development:

mongodb://localhost:27017/CyberPaste

For MongoDB Atlas (cloud):

mongodb+srv://username:password@cluster.mongodb.net/CyberPaste?retryWrites=true&w=majority

How do I find my Discord User ID?​

  1. Enable Developer Mode in Discord (Settings → Advanced → Developer Mode)
  2. Right-click on your username in any server or DM
  3. Click "Copy User ID"
  4. Use this ID as your OwnerID in config.yml

How do I configure SSL/HTTPS?​

Set useSSL: true in your config.yml and configure a reverse proxy (nginx/Apache) with SSL certificates. The application itself doesn't handle SSL certificates.

Usage​

How do I create a paste?​

  1. Visit the homepage
  2. Type or paste your content in the textarea
  3. Optionally set:
    • Max Views: Limit how many times the paste can be viewed
    • Password: Protect the paste with a password
  4. Click "Submit Paste"
  5. Copy the generated link

How do I protect a paste with a password?​

When creating a paste, enter a password in the "Password" field. The password will be hashed with bcrypt and stored securely. Users will need to enter the password to view the paste.

What happens when a paste reaches its max views?​

When a paste reaches its maximum view count, it becomes unavailable. Users will see a "Paste Expired" error message (HTTP 410).

Can I edit or delete a paste after creating it?​

Currently, CyberPaste doesn't support editing or deleting individual pastes through the web interface. However, admins can clear all pastes from the admin panel.

How long are pastes stored?​

Pastes are stored indefinitely unless:

  • They reach their maximum view count
  • Auto-delete is enabled in settings
  • An admin clears all pastes

What is the maximum paste size?​

The maximum paste size is configurable in the admin panel (default: 1MB). You can increase or decrease this limit as needed.

Admin Panel​

How do I access the admin panel?​

Visit /staff on your CyberPaste instance. You must be logged in with Discord and your Discord User ID must match the OwnerID in config.yml.

What can I do in the admin panel?​

  • View real-time statistics
  • Update general settings (site name, colors, description)
  • Configure security settings (rate limits, paste size limits)
  • Update advanced settings (auto-delete, syntax highlighting)
  • Upload custom logo and favicon
  • Clear all pastes

How do I change the site name and colors?​

  1. Log in to the admin panel
  2. Go to "General Settings"
  3. Update the site name, secondary color, or description
  4. Click "Save Settings"
  1. Log in to the admin panel
  2. Go to "General Settings"
  3. Click "Choose File" under "Logo"
  4. Select an image file (JPEG, PNG, GIF, SVG, ICO)
  5. Click "Upload Logo"
  6. The logo will be updated immediately

How do I configure rate limits?​

  1. Log in to the admin panel
  2. Go to "Security Settings"
  3. Adjust the rate limits:
    • Web Rate Limit: Requests per window for web endpoints
    • Web Rate Limit Window: Time window in minutes
    • API Rate Limit: Requests per window for API endpoints
    • API Rate Limit Window: Time window in minutes
  4. Click "Save Settings"

What happens when I clear all pastes?​

All pastes in the database will be permanently deleted. This action is irreversible. Make sure you have a backup if needed.

API​

Can I use the API without authentication?​

Yes, public endpoints like creating and viewing pastes don't require authentication. However, admin endpoints require authentication and owner permissions.

How do I authenticate API requests?​

For admin endpoints, you need to:

  1. Log in via Discord OAuth (web browser)
  2. Obtain your session cookie
  3. Include the session cookie in API requests

What is the API rate limit?​

The default API rate limit is 100 requests per 60 minutes. This is configurable in the admin panel.

How do I handle rate limiting?​

When you hit the rate limit, you'll receive a 429 Too Many Requests response. Implement exponential backoff and retry after the rate limit window resets.

Can I use the API programmatically?​

Yes, you can use the API programmatically. However, for admin endpoints, you'll need to manage session cookies. Consider using a headless browser or session management library.

Security​

Is CyberPaste secure?​

Yes, CyberPaste includes multiple security features:

  • CSRF protection
  • Rate limiting
  • Password hashing (bcrypt)
  • Secure session management
  • Input validation
  • File upload validation

How are passwords stored?​

Passwords are hashed using bcrypt with 12 salt rounds. Plain text passwords are never stored in the database.

Is my data encrypted?​

Paste content is stored in plain text in MongoDB. If you need encryption at rest, configure MongoDB encryption or use encrypted storage volumes.

Can I enable HTTPS?​

Yes, configure a reverse proxy (nginx/Apache) with SSL certificates and set useSSL: true in config.yml.

How do I protect against DDoS attacks?​

CyberPaste includes rate limiting to mitigate DDoS attacks. For additional protection, consider using a CDN, firewall, or DDoS protection service.

Troubleshooting​

The application won't start. What should I do?​

  1. Check that Node.js version is 18 or higher: node --version
  2. Verify MongoDB is running and accessible
  3. Check that config.yml is properly configured
  4. Ensure all dependencies are installed: npm install
  5. Check the console for error messages

I'm getting a MongoDB connection error.​

  1. Verify MongoDB is running
  2. Check the connection string in config.yml
  3. Ensure MongoDB is accessible from your server
  4. Check firewall rules
  5. Verify MongoDB credentials are correct

Discord OAuth is not working.​

  1. Verify Client ID and Client Secret in config.yml
  2. Check that the redirect URI matches exactly in Discord Developer Portal
  3. Ensure the redirect URI uses the correct protocol (http/https)
  4. Check that the Discord application is not in restricted mode

Pastes are not being created.​

  1. Check that MongoDB is connected
  2. Verify rate limits are not exceeded
  3. Check that paste content is not empty
  4. Verify paste size is within limits
  5. Check console for error messages

I can't access the admin panel.​

  1. Verify you're logged in with Discord
  2. Check that your Discord User ID matches OwnerID in config.yml
  3. Ensure the OwnerID is a string (not a number)
  4. Try logging out and logging back in

Rate limiting is too strict.​

You can adjust rate limits in the admin panel under "Security Settings". Increase the rate limit or window duration as needed.

File uploads are failing.​

  1. Check that the file type is supported (JPEG, PNG, GIF, SVG, ICO)
  2. Verify file size is under 2MB
  3. Check that the uploads directory exists and is writable
  4. Verify disk space is available

License​

How do I get a license key?​

Contact the CyberPaste developers or visit the CyberHive website for licensing information.

What happens if my license is invalid?​

The application will not start if the license key is invalid or missing. You'll see an error message indicating license validation failure.

How often is the license validated?​

The license is validated on startup and then periodically every 15 minutes. If validation fails, the application will exit.

Can I use CyberPaste without a license?​

No, a valid license key is required to run CyberPaste.

Support​

Where can I get help?​

  • Discord: Join our Discord server
  • Documentation: Check the documentation for detailed guides
  • Issues: Report bugs or issues through the appropriate channels

How do I report a bug?​

  1. Check if the issue has been reported before
  2. Gather information about the issue (error messages, logs, steps to reproduce)
  3. Contact support through Discord or the appropriate channel

Can I request a feature?​

Yes, feature requests are welcome! Contact the developers through Discord or the appropriate channel.

Miscellaneous​

Can I customize the theme?​

Yes, you can customize colors and branding through the admin panel. However, extensive theme customization may require code changes.

Does CyberPaste support multiple languages?​

CyberPaste currently supports English only. The interface language is not configurable.

Can I export my pastes?​

Currently, there's no built-in export functionality. You can access pastes via the API and export them programmatically.

Is there a mobile app?​

No, there's no dedicated mobile app. However, the web interface is fully responsive and works well on mobile devices.

Can I integrate CyberPaste with other services?​

CyberPaste provides a RESTful API that can be integrated with other services. Check the API Reference for details.

Still have questions? Join our Discord server for community support and assistance.