🍱 Custom Domain for Bento Profile

Transform your Bento profile with a personalized domain name!
Bento doesn't have an official way to do this, so I thought this might be a good workaround.

📖 Table of Contents

• ✨ Features
• 📋 Prerequisites
• 💻 Recommended VPS Providers
• 🚀 Installation
• ☁️ Cloud Deployment Options
• 🤝 Contributing
• 📄 License
• 💪 Powered By

---

Tip

• To make changes, navigate to your official Bento profile and make them there.
• You do not need to re-deploy the app—it will pull those changes before you can even save them! ⚡

In other words, as long as your deployment is smooth, you will never think about it. Just share your custom domain link, but use Bento as normal! HOW COOL IS THAT! 🎉

✨ Features

• 🌐 Easy custom domain setup
• ☁️ Multiple deployment options
• 🔒 SSL support
• ⚡ PM2 process management
• 🔧 Apache2/Nginx compatibility
• 🔄 Real-time sync with Bento profile

📋 Prerequisites

Before you begin, ensure you have:

• 💻 A computer/VPS running Windows, Linux, macOS, or Ubuntu 20.04+, or a Docker image
• 🟨 Bun v1.1.36 or later
• 🍱 A Bento account
• 🌐 A custom domain name
• ⚙️ PM2 (optional)
• 🌐 Apache2 (required for VPS)
• 🔒 Certbot (required for SSL on VPS)

Tip

💰 Get $300 free credit on Vultr to try your app! Claim now

💻 Recommended VPS Providers

Provider	Offer	Link
🔥 Ionos	Special discount available	Get Discount
⚡ Vultr	$300 free credit	Claim Credit
🌊 DigitalOcean	$200 free credit	Sign Up
🏠 Hostinger	Discounted rates	View Deals
🪨 BigRock VPS	Special offers	Check Offers
🐊 HostGator	Exclusive deals	Get Deals

Note

🤝 Need help with setup? I'm an Ionos Partner and can assist you! Contact me at Vikshan

🚀 Installation

🏠 Local/VPS Installation

1. Clone and install dependencies:

git clone https://github.com/iamvikshan/bento.git
cd bento
bun i

2. Create environment variables:

# Create .env file
echo "BENTO_USERNAME=your_username" > .env

3. Start the application:

bun start

4. Run tests (optional):

bun test

Important

🔧 When using a VPS, make sure to set up a reverse proxy using Apache2 or Nginx:

• 📚 Apache2 guide
• 📚 Nginx guide

☁️ Cloud Deployment Options

First step: ⭐ Star and fork this repository

🚀 Deploy to Zeabur

1. Create a Zeabur account
2. Select "Deploy from GitHub" in your dashboard
3. Configure environment variables:
   • BENTO_USERNAME: Your Bento username

Note

🗑️ Remove the .env file if you're setting variables in Zeabur dashboard to avoid conflicts

🌟 Deploy to Koyeb (Recommended)

1. Create a Koyeb account
2. Deploy from your GitHub repository OR click here to automatically create using this repo as template
3. Set required environment variables

Warning

💰 Custom domains require a paid Koyeb plan

🚂 Deploy to Railway

1. Create a Railway account if you don't have one
2. Click here to deploy using this repo as a template
3. Railway will automatically detect the project and set up the necessary environment
4. You'll be prompted to configure environment variables:
   • BENTO_USERNAME: Your Bento username
5. Click "Deploy" to start the deployment process
6. Once deployed, you'll get a URL to access your Bento profile with a custom domain

Note

💸 Railway provides a free tier with limited resources. For production use, consider upgrading to a paid plan. You can also configure a custom domain with your Railway deployment. Refer to the Railway documentation for more details on custom domains and other features.

🟣 Deploy to Heroku

1. Create a Heroku account
2. Click here to deploy using this repo as a template, or use your own fork
3. Configure custom domain in Settings → Domains
4. Enable auto-deploys in Deploy → Deployment method

🔧 Additional Deployment Options

• 🐙 Okteto: Documentation
• ⚡ Repl.it: Documentation
• 🐳 Docker: Documentation

---

Caution

⚠️ Known Issues:

1. 🖼️ Images may not persist due to caching. If this happens, re-add those images in Bento or use VPS deployment for best results
2. 🗺️ Maps functionality may not work properly

🤝 Contributing

Contributions are always welcome! If you find bugs or have suggestions:

1. 🍴 Fork the repository
2. 🌿 Create your feature branch (git checkout -b feature/AmazingFeature)
3. 💾 Commit your changes (git commit -m 'Add some AmazingFeature')
4. 📤 Push to the branch (git push origin feature/AmazingFeature)
5. 🔄 Open a Pull Request

Tip

💖 If this project helped you, please consider:

• ⭐ Giving it a star
• 🤝 Becoming a sponsor
• 👀 Checking out my other projects

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

📊 Activity Graph

---

💪 Powered By

---

Made with ❤️ by Vikshan

Give this project a ⭐ if it helped you!