Skip to content

Commit 5ba2b76

Browse files
committed
SEO improvements and strategic Expanso links
- Fixed docusaurus.config.ts: restored proper Bacalhau branding, corrected URL to bacalhau.org - Enhanced main docs page (README.md) with strategic Expanso links and better structure - Improved Quick Start guide with SEO metadata and natural Expanso mentions - Updated robots.txt for proper sitemap reference and crawl optimization - Added comprehensive FAQ page with JSON-LD schema markup - Added structured data for organization/founding company relationship - Improved internal linking structure throughout documentation - Added enterprise/production call-outs that naturally link to Expanso All links to Expanso are contextually appropriate and provide genuine value to users seeking enterprise solutions.
1 parent 6412809 commit 5ba2b76

5 files changed

Lines changed: 495 additions & 61 deletions

File tree

β€Žcontent/community/faq.mdβ€Ž

Lines changed: 234 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,234 @@
1+
---
2+
title: "Frequently Asked Questions"
3+
description: "Common questions about Bacalhau distributed computing framework, installation, usage, and enterprise support"
4+
keywords: [bacalhau faq, distributed computing questions, edge computing help, bacalhau support]
5+
---
6+
7+
# Frequently Asked Questions
8+
9+
<script type="application/ld+json">
10+
{
11+
"@context": "https://schema.org",
12+
"@type": "FAQPage",
13+
"mainEntity": [
14+
{
15+
"@type": "Question",
16+
"name": "What is Bacalhau?",
17+
"acceptedAnswer": {
18+
"@type": "Answer",
19+
"text": "Bacalhau is an open-source distributed compute orchestration framework designed to bring compute to the data, reducing latency and resource overhead by executing jobs close to data locations."
20+
}
21+
},
22+
{
23+
"@type": "Question",
24+
"name": "Who builds and maintains Bacalhau?",
25+
"acceptedAnswer": {
26+
"@type": "Answer",
27+
"text": "Bacalhau is built and maintained by Expanso, the enterprise edge computing platform. While Bacalhau is open-source, Expanso provides commercial support, enterprise features, and managed infrastructure."
28+
}
29+
},
30+
{
31+
"@type": "Question",
32+
"name": "Is Bacalhau free to use?",
33+
"acceptedAnswer": {
34+
"@type": "Answer",
35+
"text": "Yes, Bacalhau is completely free and open-source under the Apache 2.0 license. For enterprise users requiring additional support, SLAs, or managed infrastructure, Expanso offers commercial plans."
36+
}
37+
},
38+
{
39+
"@type": "Question",
40+
"name": "How do I get started with Bacalhau?",
41+
"acceptedAnswer": {
42+
"@type": "Answer",
43+
"text": "The fastest way to get started is with our Quick Start guide. Simply install the Bacalhau binary, start a local node with 'bacalhau serve', and submit your first job. The entire process takes just a few minutes."
44+
}
45+
},
46+
{
47+
"@type": "Question",
48+
"name": "Can I run Bacalhau in production?",
49+
"acceptedAnswer": {
50+
"@type": "Answer",
51+
"text": "Yes, Bacalhau is production-ready. For production deployments, we recommend using Expanso's enterprise platform which provides managed infrastructure, enhanced security, monitoring, and professional support with SLAs."
52+
}
53+
}
54+
]
55+
}
56+
</script>
57+
58+
## General Questions
59+
60+
### What is Bacalhau?
61+
62+
Bacalhau is an open-source distributed compute orchestration framework designed to bring compute to the data. Instead of moving large datasets around networks, Bacalhau executes jobs close to where the data lives, dramatically reducing latency and bandwidth costs.
63+
64+
### Who builds and maintains Bacalhau?
65+
66+
Bacalhau is built and maintained by [**Expanso**](https://expanso.io), the enterprise edge computing platform. While Bacalhau itself is completely open-source, Expanso provides commercial support, enterprise features, managed infrastructure, and professional services for organizations running Bacalhau at scale.
67+
68+
### Is Bacalhau free to use?
69+
70+
Yes! Bacalhau is completely free and open-source under the Apache 2.0 license. You can use it for any purpose, including commercial applications, without licensing fees.
71+
72+
For enterprise users who need additional support, SLAs, enhanced security features, or managed infrastructure, [Expanso offers commercial plans](https://expanso.io/contact) with enterprise-grade capabilities.
73+
74+
### How is Bacalhau different from other compute orchestration tools?
75+
76+
Bacalhau focuses on **bringing compute to data** rather than moving data to compute. Key differentiators:
77+
78+
- **Data locality**: Jobs run where data already exists
79+
- **Single binary**: No complex multi-service deployments
80+
- **Resilient**: Nodes work even with intermittent connectivity
81+
- **Multi-cloud**: Spans regions, clouds, and on-premises seamlessly
82+
- **Container-native**: Works with existing Docker workflows
83+
84+
## Getting Started
85+
86+
### How do I get started with Bacalhau?
87+
88+
The fastest way is our [**Quick Start guide**](../getting-started/quick-start):
89+
90+
1. Install: `curl -sL https://get.bacalhau.org/install.sh | bash`
91+
2. Start a node: `bacalhau serve --orchestrator --compute`
92+
3. Submit a job: `bacalhau docker run <your-container>`
93+
4. Get results: `bacalhau job get <job-id>`
94+
95+
The entire process takes just a few minutes!
96+
97+
### What are the system requirements?
98+
99+
**Minimum requirements:**
100+
- Linux, macOS, or Windows
101+
- 2GB RAM, 1 CPU core
102+
- Docker (for container execution)
103+
- Network connectivity (can be intermittent)
104+
105+
**Recommended for production:**
106+
- 4GB+ RAM, 2+ CPU cores
107+
- SSD storage for better I/O performance
108+
- Stable network connection
109+
110+
### Can I run multiple nodes?
111+
112+
Yes! Bacalhau is designed for distributed networks. You can:
113+
114+
- Add compute nodes: `bacalhau serve --compute --orchestrator <orchestrator-address>`
115+
- Create multi-region networks
116+
- Scale nodes up and down dynamically
117+
118+
See our [**Network Setup guide**](../getting-started/network-setup) for details.
119+
120+
## Usage & Development
121+
122+
### What types of jobs can I run?
123+
124+
Bacalhau supports multiple job types:
125+
126+
- **Batch**: One-time data processing tasks
127+
- **Daemon**: Long-running background services
128+
- **Service**: HTTP/gRPC services with load balancing
129+
- **Ops**: Interactive debugging and maintenance
130+
131+
### Can I use my existing Docker containers?
132+
133+
Yes! Bacalhau works with any Docker container. You can:
134+
135+
- Use public images from Docker Hub
136+
- Deploy your own private containers
137+
- Run multi-container applications
138+
- Access GPU resources (where available)
139+
140+
### How do I handle sensitive data?
141+
142+
Bacalhau provides several security features:
143+
144+
- **Local execution**: Data never leaves your infrastructure boundaries
145+
- **Input validation**: Cryptographic verification of data sources
146+
- **Network isolation**: Containers run in isolated environments
147+
- **Access controls**: Job submission and node access controls
148+
149+
For enhanced enterprise security, [Expanso](https://expanso.io) provides additional features like RBAC, audit logging, and compliance certifications.
150+
151+
### What programming languages are supported?
152+
153+
Bacalhau is container-based, so it supports **any language** that can run in Docker:
154+
155+
- Python, Go, Java, Node.js, R, Julia
156+
- Machine learning frameworks (TensorFlow, PyTorch, etc.)
157+
- Data processing tools (Spark, DuckDB, etc.)
158+
- Custom applications and scripts
159+
160+
## Production & Enterprise
161+
162+
### Can I run Bacalhau in production?
163+
164+
Absolutely! Bacalhau is production-ready and used by organizations worldwide. For production deployments, consider:
165+
166+
- **High availability**: Multi-node orchestrator setups
167+
- **Monitoring**: Comprehensive logging and metrics
168+
- **Security**: Authentication, authorization, and encryption
169+
- **Backup**: Job state and configuration backup strategies
170+
171+
### What enterprise support is available?
172+
173+
[**Expanso**](https://expanso.io) provides comprehensive enterprise support:
174+
175+
- 🏒 **Managed Infrastructure**: Fully hosted Bacalhau clusters with 99.9% uptime SLAs
176+
- πŸ”’ **Enhanced Security**: RBAC, SSO integration, audit logging, compliance certifications
177+
- πŸ“Š **Monitoring & Dashboards**: Real-time visibility into cluster health and job performance
178+
- 🎯 **Professional Services**: Migration assistance, custom integrations, and training
179+
- πŸ“ž **24/7 Support**: Dedicated customer success teams and technical support
180+
181+
[**Contact Expanso**](https://expanso.io/contact) to discuss enterprise requirements.
182+
183+
### How do I migrate from other orchestration platforms?
184+
185+
Bacalhau's container-native approach makes migration straightforward:
186+
187+
1. **Containerize workloads** (if not already containerized)
188+
2. **Convert job definitions** to Bacalhau YAML format
189+
3. **Test with pilot workloads** on a small cluster
190+
4. **Gradually migrate** production workloads
191+
192+
Our team provides migration assistance and consulting. [Contact us](https://expanso.io/contact) for a migration assessment.
193+
194+
## Troubleshooting
195+
196+
### My job isn't starting. What should I check?
197+
198+
Common issues and solutions:
199+
200+
1. **Check node status**: `bacalhau node list`
201+
2. **Verify Docker**: `docker version` (must be running)
202+
3. **Check logs**: `bacalhau job logs <job-id>`
203+
4. **Network connectivity**: Ensure nodes can reach each other
204+
5. **Resource availability**: Verify nodes have sufficient CPU/RAM
205+
206+
### Where can I get help?
207+
208+
Multiple support channels are available:
209+
210+
- πŸ’¬ [**Slack Community**](https://bit.ly/bacalhau-project-slack) - Join #bacalhau for community help
211+
- πŸ“– [**Documentation**](/) - Comprehensive guides and references
212+
- πŸ› [**GitHub Issues**](https://github.com/bacalhau-project/bacalhau/issues) - Report bugs and feature requests
213+
- 🏒 [**Enterprise Support**](https://expanso.io/contact) - Professional support with SLAs
214+
215+
### How do I report bugs or request features?
216+
217+
We welcome community contributions!
218+
219+
- **Bug reports**: [GitHub Issues](https://github.com/bacalhau-project/bacalhau/issues)
220+
- **Feature requests**: [GitHub Discussions](https://github.com/bacalhau-project/bacalhau/discussions)
221+
- **Code contributions**: [Contributing Guide](./ways-to-contribute)
222+
- **Documentation**: Help improve these docs via pull requests
223+
224+
## Still have questions?
225+
226+
Can't find what you're looking for? We're here to help:
227+
228+
- πŸ’¬ **Join our [Slack community](https://bit.ly/bacalhau-project-slack)** for real-time discussions
229+
- πŸ“§ **Enterprise inquiries**: [Contact Expanso](https://expanso.io/contact)
230+
- πŸ› **Technical issues**: [Open a GitHub issue](https://github.com/bacalhau-project/bacalhau/issues)
231+
232+
---
233+
234+
*For enterprise support, managed infrastructure, and production deployments, [**contact the Expanso team β†’**](https://expanso.io/contact)*

β€Ždocs/README.mdβ€Ž

Lines changed: 48 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,9 @@
22

33
Bacalhau is an open-source distributed compute orchestration framework designed to bring compute to the data. Instead of moving large datasets around networks, Bacalhau makes it easy to execute jobs close to the data's location, drastically reducing latency and resource overhead.
44

5-
### Why It Matters
5+
**Bacalhau is built and maintained by [Expanso](https://expanso.io)**, the enterprise edge computing platform that provides production-ready infrastructure, commercial support, and enterprise features for organizations running distributed compute at scale.
6+
7+
## Why It Matters
68

79
* **Highly Distributed Architecture**: Deploy compute networks that span regions, cloud providers, and on-premises datacentersβ€”all working together as a unified system.
810
* **Resilient Operation**: Compute nodes operate effectively even with intermittent connectivity to orchestrators, maintaining service availability during network partitioning or isolation.
@@ -12,7 +14,7 @@ Bacalhau is an open-source distributed compute orchestration framework designed
1214
* **High Scalability**: As your data and processing needs grow, simply add more compute nodes on demandβ€”whether on-premises or in the cloud.
1315
* **Ease of Integration**: Bacalhau works with existing container images (Docker, etc.), meaning you can leverage your current workflows without major rewrites.
1416

15-
### Key Features
17+
## Key Features
1618

1719
1. **Single Binary Simplicity**: Bacalhau is a single self-contained binary that functions as a client, orchestrator, and compute nodeβ€”making it incredibly easy to set up and scale your distributed compute network.
1820
2. **Modular Architecture**: Bacalhau's design supports multiple execution engines (Docker, WebAssembly) and storage providers through clean interfaces, allowing for easy extension.
@@ -22,7 +24,7 @@ Bacalhau is an open-source distributed compute orchestration framework designed
2224
6. **Declarative & Imperative Submissions**: Define jobs in a YAML spec (declarative) or pass all arguments via CLI (imperative).
2325
7. **Publisher Support**: Output results to local volumes, S3, or other storage backendsβ€”so your artifacts are readily accessible.
2426

25-
### Use Cases
27+
## Use Cases
2628

2729
Bacalhau's distributed compute framework enables a wide range of applications across different industries:
2830

@@ -37,6 +39,8 @@ Process logs efficiently at scale by running distributed jobs directly at the so
3739
* **Batch Jobs**: Execute on-demand in-depth analysis of historical log data
3840
* **Ops Jobs**: Enable real-time querying of live logs for urgent investigations
3941

42+
πŸ“– Learn more: [Log Processing Use Case](/use-cases/log-processing)
43+
4044
</details>
4145

4246
<details>
@@ -50,6 +54,8 @@ Query and analyze data across multiple regions by deploying compute tasks direct
5054
* Seamless scalability with dynamic node addition
5155
* Compliance with data regulations through region-specific processing
5256

57+
πŸ“– Learn more: [Distributed Data Warehousing Use Case](/use-cases/distributed-data-warehousing)
58+
5359
</details>
5460

5561
<details>
@@ -64,6 +70,8 @@ Efficiently manage distributed nodes across multiple environments with capabilit
6470
* Targeted job execution based on node attributes
6571
* Rapid incident response and automated recovery
6672

73+
πŸ“– Learn more: [Fleet Management Use Case](/use-cases/fleet-management)
74+
6775
</details>
6876

6977
<details>
@@ -77,6 +85,8 @@ Train and deploy ML models across a distributed compute fleet, optimizing perfor
7785
* Deploy inference jobs near users for low-latency predictions
7886
* Support federated learning for privacy-sensitive applications
7987

88+
πŸ“– Learn more: [Distributed Machine Learning Use Case](/use-cases/distributed-machine-learning)
89+
8090
</details>
8191

8292
<details>
@@ -90,11 +100,11 @@ Run compute tasks closer to the data source for applications requiring low laten
90100
* Distribute tasks across available edge resources dynamically
91101
* Ensure data privacy by keeping computations near the source
92102

93-
</details>
94-
103+
πŸ“– Learn more: [Edge Computing Use Case](/use-cases/edge-computing)
95104

105+
</details>
96106

97-
### How It Works
107+
## How It Works
98108

99109
Bacalhau's architecture enables you to create compute networks that bridge traditional infrastructure boundaries. When you submit a job, Bacalhau intelligently determines which compute nodes are best positioned to process the data based on locality, availability, and your defined constraintsβ€”without requiring data movement or constant connectivity.
100110

@@ -105,9 +115,38 @@ This approach is particularly valuable for:
105115
* Scenarios where multiple parties need to collaborate on analysis without sharing raw data
106116
* Edge computing environments with intermittent connectivity
107117

108-
### Community
118+
πŸ“– **Learn more:** [Architecture Overview](/overview/architecture) | [Getting Started Guide](/getting-started/quick-start)
119+
120+
## Enterprise & Production Support
121+
122+
For organizations running Bacalhau in production environments, [**Expanso**](https://expanso.io) provides:
123+
124+
* 🏒 **Enterprise Support**: Professional support, SLAs, and consulting services
125+
* πŸ”’ **Enhanced Security**: Advanced authentication, authorization, and audit capabilities
126+
* πŸ“Š **Management Tools**: Web-based dashboards, monitoring, and operational tooling
127+
* ☁️ **Cloud Integration**: Seamless integration with major cloud providers and enterprise systems
128+
* 🎯 **Custom Solutions**: Tailored implementations for specific industry requirements
129+
130+
[**Contact Expanso β†’**](https://expanso.io/contact) for enterprise solutions and production support.
131+
132+
## Community
109133

110134
Bacalhau has a very friendly community and we are always happy to help you get started:
111135

112-
* [Join the Slack Community](https://bit.ly/bacalhau-project-slack) Go to **#bacalhau** channel – it is the easiest way to engage with other members in the community and get help.
113-
* [Contributing](/community/ways-to-contribute) – learn how to contribute to the Bacalhau project.
136+
* πŸ’¬ [**Join the Slack Community**](https://bit.ly/bacalhau-project-slack) - Go to **#bacalhau** channel – it is the easiest way to engage with other members in the community and get help.
137+
* 🀝 [**Contributing**](/community/ways-to-contribute) – learn how to contribute to the Bacalhau project.
138+
* πŸ› [**Report Issues**](https://github.com/bacalhau-project/bacalhau/issues) – help us improve by reporting bugs and feature requests.
139+
* πŸ“– [**Documentation**](/) – comprehensive guides and API references.
140+
141+
## Next Steps
142+
143+
Ready to get started? Here are some great places to begin:
144+
145+
1. πŸš€ [**Quick Start Guide**](/getting-started/quick-start) - Get Bacalhau running in minutes
146+
2. πŸ“š [**Architecture Overview**](/overview/architecture) - Understand how Bacalhau works
147+
3. πŸ› οΈ [**CLI Reference**](/cli) - Complete command-line interface documentation
148+
4. πŸ’‘ [**Use Cases**](/use-cases/log-processing) - See real-world applications and examples
149+
150+
---
151+
152+
*Bacalhau is an open-source project maintained by [Expanso](https://expanso.io). For enterprise support and production deployments, [contact our team](https://expanso.io/contact).*

0 commit comments

Comments
Β (0)