How do I deploy next-woo on Railway?

You can deploy next-woo on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: next-woo-d17d03be, or join our Discord community for more assistance.

Deploy and Host next-woo on Railway

next-woo is a headless WooCommerce storefront built with Next.js 16, React 19, and TypeScript. It features product browsing, cart, checkout (via WooCommerce), and blog support. Includes a pre-configured WordPress container with WooCommerce and cache revalidation plugin.

About Hosting next-woo

This template deploys a complete headless WooCommerce stack: a MySQL database, WordPress with WooCommerce, and Next.js frontend. WordPress and WooCommerce handle products, orders, and payments while Next.js delivers a fast, modern storefront. The included revalidation plugin automatically invalidates the Next.js cache when products or content change, ensuring your store always shows fresh data. Environment variables are pre-configured to connect all three services securely.

Common Use Cases

E-commerce stores wanting modern performance with WordPress's familiar admin
Agencies building custom storefronts for clients who manage their own products
Existing WooCommerce stores migrating to a headless frontend
Stores requiring custom checkout flows or unique frontend experiences

Dependencies for next-woo Hosting

MySQL 8.0+ (included in template)
WordPress 6.x with WooCommerce 8.x (included in template)

Deployment Dependencies

Implementation Details

After deployment, WordPress auto-installs with WooCommerce and the revalidation plugin pre-configured.

Post-Deployment Setup:

Wait for WordPress to finish initializing (first deploy takes a few minutes)
Visit your WordPress admin at https://your-wordpress-domain/wp-admin

WORDPRESS_ADMIN_USER=admin
WORDPRESS_ADMIN_PASSWORD=your-secure-password
[email protected]

Go to WooCommerce → Settings → Advanced → REST API
Generate API keys with Read/Write permissions
Update your Next.js service environment variables with the real keys:
```
WC_CONSUMER_KEY=ck_xxxxx
WC_CONSUMER_SECRET=cs_xxxxx
```
Redeploy the Next.js service to pick up the new keys

To persist uploads and product images between deploys, Pro plan users can add a volume at /var/www/html/wp-content.

Why Deploy next-woo on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying next-woo on Railway, you get a complete e-commerce stack with minimal configuration. Host your storefront, database, and CMS together on one platform.